home *** CD-ROM | disk | FTP | other *** search
/ Lovely Ladies 2 / Lovely Ladies II.iso / vpic / config.doc < prev    next >
Text File  |  1991-07-23  |  8KB  |  139 lines
  1. CONFIGURING VPIC
  2.  
  3. VPIC must be configured to run correctly with your display board. The
  4. configuration process tells VPIC:
  5.     1. The title you want for the menu.
  6.     2. What VGA chip you have, so it can use the proper bank switching routine.
  7.     3. How much memory you have (in 64K banks).
  8.     4. The menu color you want (background:foreground).
  9.     5. How to set the various modes you want to use.
  10.  
  11. If you aren't sure which VGA chip your board uses, you can run WHICHVGA, which
  12. will try to identify your VGA chip and the amount of memory you have. If this
  13. doesn't work, you can remove the display board and look at the label on the
  14. large chip with leads coming out all four sides. Sometimes, you can tell without
  15. removing the board by using DEBUG (or Turbo Debugger, Codeview, or any debugger)
  16. and 'dumping' the contents of display BIOS. To do this, enter DEBUG at the DOS
  17. prompt and you will get a - prompt. Then enter d C000:0 to display the first
  18. part of display BIOS. To dump more of BIOS, juts enter d. You may recognize the
  19. chip manufacturers name here, such as ATI, Trident, Tseng, Paradise, etc. To
  20. exit DEBUG, just enter q.
  21.  
  22. If WHICHVGA comes back with VESA, that means that your board supports the VESA
  23. standard, which offers a standard interface for VPIC to your SuperVGA display
  24. adapter. It defines the SuperVGA extended modes that your card will do, and has
  25. a standard interface for setting the mode and bank switching, etc. You may have
  26. received a VESA `Terminate and Stay Resident' (TSR) program with your VGA board.
  27. If so, you are encouraged to use it, since it more or less guarantees that VPIC
  28. will work with your display card. The only disadvantage of VESA is concerned
  29. with scrolling the VGA screen, since there is no standard interface for setting
  30. the top of screen beyond 16 bits (line 81 at 800x600x256, line 102 at
  31. 640x480x256, or line 204 at 320x200x256).
  32.  
  33. This version of VPIC does not automatically read the VESA info from your display
  34. BIOS, so you will have to modify the VESA.CFG file to reflect what WHICHVGA
  35. returned. Note the modes that are displayed, then put a semicolon in front of
  36. the modes in VESA.CFG that were not returned, and save the VESA.CFG file. Then,
  37. run CVPIC VESA to configure VPIC for a VESA board. A later version of VPIC will
  38. automatically detect the VESA BIOS, and read and use the modes defined by the
  39. VESA BIOS; it will not have to be configured unless the display adapter doesn't
  40. support VESA.
  41.  
  42. The current VGA chips and the config file chip names are:
  43. CFG File    Manufacturer/version        Comments
  44. =================================================================
  45. AHEADA      Ahead ver A             Older Ahead cards.
  46. AHEADB      Ahead ver B             Ahead VGA Wizard/Deluxe.
  47. ATIOLD      ATI, 1024x768x16 mode 65h   ATI ver 1 chip, VGAWonder
  48. ATINEW      ATI, 1024x768x16 mode 55h   ATI ver 2 up chip, VGAWonder+
  49. CIRRUS      Cirrus CL-GD 500/600    MaxLogic MaxVGA boards NOT SUPPORTED YET
  50. CHIPSTECH   Chips & Technology 82C452   Cardinal, Older Boca
  51. EVEREX      Original Everex chip
  52. EVBIOS      Everex 673, etc         Has bank switching built into BIOS
  53. GENOA       Genoa (Sim ET 3000)     5300/6300 = 256K, others = 512K
  54. HEADLAND    Headland HT-208         Used on VGA-1024i
  55. OAK         Oak
  56. PARADISE    Paradise                Older Paradise cards
  57. TRI88BR     Trident TVGA 8800BR     Used on older Trident boards, 128K banks.
  58. TRI88CS     Trident TVGA 8800CS     Used on newer Trident boards (Maxxon, Logix)
  59. TRI89       Trident TVGA 8900       Latest Trident VGA chip, 1M memory avail.
  60. TS3000      Tseng ET 3000           Used on early Genoa, Orchid, others
  61. TS4000      Tseng ET 4000           Recent Orchid, STB, other, 1M memory avail.
  62. TS4000HI    Tseng ET 4000 HiColor   Does 32K colors to 800x600, 1M memory avail.
  63. WD90C      Western Digital WD90C00  Recent Paradise cards, same operation.
  64. VIDEO7      Video 7                 Earlier Video 7 boards, BIOS bank switching.
  65. ZYMOS       Zymos Poach 51          True Tech HiRes and others.
  66. VESA        VESA Standard           For boards which have VESA in BIOS. This will
  67.                                     be auto-detected soon. Run WHICHVGA to see.
  68.  
  69. As new chips become available, they will be added to this list. Run WHICHVGA to
  70. find your VGA chip (works most of the time), and then run CONFIG and find a CFG
  71. file using that VGA chip. Check that the modes agree with the graphics modes in
  72. your manual (16 and 256 color modes only); if they match your card exactly, use
  73. that CFG file by pressing ENTER. If not, copy the closest file to a new filename
  74. with extension CFG and change the modes to agree with your manual. Make the
  75. title and menu color whatever you like (see CONFIGURATION FILE FORMAT). Then
  76. rerun CONFIG, pick that file, and press ENTER to configure VPIC. There are
  77. numerous configuration files which come with VPIC, but there are so many boards
  78. out there that I can't list all of them.
  79.  
  80. MENU CONFIGURATION
  81. To configure VPIC, make sure that VPIC, CVPIC, CONFIG, and all the .CFG files
  82. are in the current directory. By running the CONFIG program, VPIC can be
  83. configured from a menu. CONFIG lists all the configuration files (with a .cfg
  84. extension) in the current directory, and shows you the contents of each as you
  85. move around the list using the cursor keys. ESCape aborts the CONFIG program
  86. without changing VPIC, and ENTER configures VPIC for the highlighted file.
  87. Pressing a letter key jumps to next filename starting with that letter (or
  88. number).
  89.  
  90. MANUAL CONFIGURATION
  91. You can use CVPIC to configure VPIC manually by entering
  92.      CVPIC config_file[.ext]
  93. where the default extension is .cfg.
  94.  
  95. CONFIGURATION FILE (.CFG) FORMAT
  96. CVPIC ignores leading spaces and blank lines in the file, and all characters
  97. after a semicolon are considered comments and ignored. The .CFG file contains
  98. the following lines, which can be up to 150 characters in length each:
  99.  
  100.     1. Board name, which will appear in the VPIC menu. This is user defineable,
  101.        and could be something like 'Joe's VGA Board'.
  102.  
  103.     2. VGA CHIP should be one of the names supported by VPIC; see above. Upper
  104.        or lower case is OK.
  105.  
  106.     3. The number of 64K banks of display ram usable for pictures (1 for
  107.        standard VGA (no extended modes), 4 for 256K, 8 for 512K, 16 for 1M).
  108.  
  109.     4. Menu text color. A number whose value is (background*16 + foreground).
  110.        The allowable background colors are 0 thru 7, and the allowable
  111.        foreground colors are 0 thru 15. This number is easiest to figure if
  112.        entered in hex (prefixed by 0x); then the 1st digit is the background
  113.        color (0-7) and the 2nd digit is the foreground color (0-F). The digits
  114.        correspond to black (0), blue (1), green (2), aqua (3), red (4),
  115.        violet (5), brown (6), and white (7), and the digits 8-F are intensified
  116.        versions of the 0-7. For example, 0x3E would tell VPIC to use bright
  117.        yellow text on an aqua background. CONFIG gives the value in hex, and the
  118.        corresponding foreground-background colors.
  119.  
  120.     5 thru n. The following lines describe the modes supported by the board.
  121.       Each line is of the form: F1 F2 AX BX CX DX W H C G P where:
  122.         *  F1 = VGA (256 color) mode flag.
  123.         *  F2 = 256K colors to choose from flag (as in mode 12h, 640x480x16 or
  124.            any 256 color mode).
  125.         *  AX,BX,CX,DX  register values used to set this mode. Preceeding the
  126.            numbers by 0x indicates hex; ie., 0x10 = 16.
  127.         *  W, H, C  are width, height, colors in this mode.
  128. VESA.CFG ONLY
  129.         *  G is the VESA Granularity in Kilobytes; you only need to specify this
  130.            if WHICHVGA returned VESA and a Granularity of less than 64K for a
  131.            mode; ie, if the Granularity for a mode was 4K, use 4 for this field.
  132.         *  P is the number of color planes; usually 1 for 256 color modes and 4
  133.            for 16 color modes. However, the ATI in 1024x768x16 uses 1 plane and
  134.            2 pixels/byte.
  135.  
  136.       All the VGA (256 color) modes should be grouped first, followed by the EGA
  137.       (16 color) modes.
  138.  
  139.